home *** CD-ROM | disk | FTP | other *** search
/ Aminet 27 / Aminet 27 (1998)(GTI - Schatztruhe)[!][Oct 1998].iso / Tools / Docs / PS3M < prev    next >
Text File  |  1995-01-08  |  17KB  |  513 lines
  1. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  2. ­                PS3M ® 3.05ß / 08.01.94            ­
  3. ­              Copyright © 1994-95 Jarno Paananen        ­
  4. ­                 Guru / Sahara Surfers            ­
  5. ­             A Sahara Surfers Product 1994            ­
  6. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  7.  
  8. Some words about PS3M:
  9. ­­­­­­­­­­­­­­­­­­­­­­
  10.  
  11. This little thing could be just another program to play music.  It wouldn't
  12. even be the first one I have done.  The only special thing is that it plays
  13. S3M-modules.  For those to whom that word says nothing, can be told that
  14. they are the modules from all newer Future Crew demos (from Fishtro
  15. onwards), compotunes and the three Journey musicdisks from Purple Motion
  16. and Chaotic Mind from Skaven.   After the recent release of Screamtracker
  17. 3.01 Beta more and more modules are obviously coming from other musicians
  18. too, as it really is the best tracker on the PC.  As they use 1-32
  19. channels (although "only" 16 digital channels and 9 AdLib-channels) and 8
  20. octaves, a normal Amiga is not capable to play them, right?  Yes, until
  21. now.
  22.  
  23. From version 000.9 onwards also 6-8 channel Fasttracker modules can be
  24. played with PS3M (should I change the name?!?).  Although you can also
  25. play 4-channel Protracker tunes, I think there are faster programs
  26. available for that :)...
  27.  
  28. In version 002.5 came support for Multitracker (MTM) modules and 1-32
  29. channel Protracker-style modules (Taketracker and Fasttracker 2(?)).
  30.  
  31. AND AGAINST (TOO) POPULAR OPINION, WORKS FINE UNDER KS1.2! (hadn't tried
  32. on 1.1 ;) WITH APPROPRIATE REQTOOLS.LIBRARY.
  33.  
  34. Reqtools and Powerpacker libraries (by Nico François) required.
  35.  
  36.  
  37. !!NOTICE!!:
  38. ­­­­­­­­­­­
  39. From version 002.0 onwards, PS3M has a config file!  Use of it is
  40. _recommended_!
  41.  
  42.  
  43. Technical "information":
  44. ­­­­­­­­­­­­­­­­­­­­­­­­
  45.  
  46. This player makes quite a big difference to those "normal" Amiga players as
  47. it has to mix all those channels to, in this case two, normal channels.
  48. This is the normal convention on the PC as for example normal Sound Blaster
  49. only has one digital channel.  The only hard part is to make it fast still
  50. having great sound quality.  For those interested, this mixing routine is
  51. not one of those lame ones like in Startrekker, Octamed, Oktalyzer and so
  52. on.  It has real volumes and periods for each channel unlike the former ones
  53. that control the volume with hardware and have no independent volume
  54. control for channels.  It mixes the sound in 16 bits for maximum quality and
  55. has a volume boosting option to make the sound louder and clearer with
  56. multiple (8+) channels.  From version 002.5 onwards also a special 14-bit
  57. output mode is available.  The actual mixing loop is highly optimized and
  58. has only 6 instructions (is faster than the one with 5...) per byte.  All
  59. this makes it possible to play even 8 channel S3Ms with high mixing rates
  60. and great quality on a normal 000-Amiga.  The better (faster) your machine
  61. is, the higher rates you get.  It is designed to use as little chip-ram as
  62. possible to fasten up on machines with real fast-ram.  The system is by
  63. default disabled for the playing to get the maximum performance out of a
  64. normal stock-000.  From 000.2 onwards, system friendly option is included
  65. for those with AGA- or turbomachines and even us poor mortals...  On a
  66. stock A500 it jams your machine nearly completely, so be careful.  Still I
  67. use it quite a lot on my A500-010-FAST, so it isn't too bad after all...
  68.  
  69. The blue bars at the bottom of the screen indicate that the player has
  70. free time.  This helps you to tune the maximum mixing rate for each tune
  71. separately.
  72.  
  73.  
  74. "Surround" or Surround?
  75. ­­­­­­­­­­­­­­­­­­­­­­­
  76.  
  77. There has been some argue about whether the surround option is a real
  78. Dolby Surround or not.  Therefore: IT HAS NOTHING TO DO WITH THAT DOLBY
  79. THING, it is made just to enchance the dull stereo sound by playing
  80. the two buffers from left and right with full volume and vice versa with
  81. half of the volume.  Like this:
  82.     Channel 0 - Left buffer, full volume
  83.     Channel 1 - Right buffer, full volume
  84.     Channel 2 - Left buffer, half volume
  85.     Channel 3 - Right buffer, half volume
  86.  
  87. This should end that discussion.  Thanks for the ones who contributed
  88. with pertinent response.
  89.  
  90. BUT!!!!
  91.  
  92. As everything changes these days, also PS3M now has Real Surround-option.
  93. It needs a little more processor power, but not that much I though.  Also
  94. double the chip memory is needed for extra buffers.  It enchances the
  95. sound nicely with headphones and is nice also with normal speakers.  And
  96. if you got the Dolby Prologic decoder (lucky you!), you should get the
  97. effect quite nicely...
  98.  
  99.  
  100. Some commercial advertisement:
  101. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  102. This PS3M-routine is also used in the following players, so if you are
  103. not content with the "user-interface", use these:
  104.  
  105. DASMP from DAS Design (from 3.0 onwards)
  106.  
  107. HippoPlayer from Hippopotamus Design (MUST for under 2.0 Kickstarts, we
  108. still do exist!)
  109.  
  110. DeliTracker II already has a S3M-DeliPlayer (Hi Peter!) and should
  111. be available in near future.  Update: was released with version 2.07.
  112.  
  113. EaglePlayer (Version >1.52?)
  114.  
  115. Accessible Player (Version 1.2? ;)
  116.  
  117. Possibly in new SmartPlay (if there will be one?)
  118.  
  119.  
  120. Get yourself The Player 6.1, available since Assembly'94!
  121.  
  122.  
  123.  
  124.  
  125. Legal stuff:
  126. ­­­­­­­­­­­­
  127.  
  128.         This program and all other stuff coming in this package are
  129.                            FULLY copyrighted by
  130.  
  131.                  Jarno Paananen / Guru of Sahara Surfers.
  132.                  ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  133.  
  134. The author cannot be held liable for the suitability or accuracy of this
  135. manual and/or the program it describes.  Any damage directly or indirectly
  136. caused by the use or misuse of this manual and/or the program it describes
  137. is the sole responsibility of the user her/him self.
  138.  
  139. This program is freeware.  You can distribute it as long as _ALL_ files are
  140. included and not more than a nominal fee for copying is asked.  This program
  141. can _NOT_ be used for commercial purposes (including shareware) without
  142. a written permission from the author and a contribution for development
  143. costs (like Coca-Cola :-).  If you have suggestions or remarks about this
  144. program, or if you find any bugs, please let me know.
  145.  
  146. All reverse engineering is forbidden and that means that you're not allowed
  147. to rip the player from this program as I'm intending to use it for
  148. commercial purposes.  If this happens I have to stop releasing these kind of
  149. programs.  If you are really interested and want to use this in some
  150. production, contact me and we can discuss about it.  It's up to you...
  151.  
  152.  
  153.  THIS IS A BETA-PRERELEASE-TEST VERSION AND IS IN CONSTANT CHANGE. FURTHER
  154.              VERSIONS ARE COMING IF THE ABOVE IS NOT VIOLATED.
  155.  
  156.  
  157.  
  158. Contact address:
  159. ­­­­­­­­­­­­­­­­
  160.  
  161. If you for some odd reason (especially commercial stuff) want to contact me,
  162. the address is:
  163.  
  164.                 J. Paananen
  165.                    Puskalantie 6
  166.                   FIN-37120 Nokia
  167.                   Finland
  168.                  European Union ;)
  169.  
  170.            Or by phone: +358-31-3422147 / Jarno
  171.  
  172.  
  173.             Or preferably via Internet:
  174.  
  175.               Jarno_Paananen@sonata.fipnet.fi
  176.                   (NO UUENCODES!)
  177.  
  178.                     or
  179.  
  180.                jpaana@freenet.hut.fi
  181.  
  182. At the moment the Sonata address is recommended, but allows NO
  183. uuencodes.  In that case use Freenet until I get a decent Internet
  184. access.
  185.  
  186.  
  187. Some revision history:
  188. ­­­­­­­­­­­­­­­­­­­­­­
  189.  
  190. 3.05ß / 08.01.1995
  191. ­­­­­­­­­­­­­­­­­­
  192.     ! Happy new year!  We're in the European Union!  Greetings
  193.       to all who were at The Party'94!  Especially Accessible guys
  194.       and Spoon (Hi Shayera, I'll hopefully send it soon...)
  195.  
  196.     + PS3M can now be closed with CTRL_C signal, but unfortunately
  197.       not in Reqtools-windows.  Hi Urban!
  198.     + You're now able to define also default playing mode for a
  199.       specific module in the config file.  Check it out for an
  200.       example. Hi (damn I have a short memory with names... Anyway,
  201.       you should know who you are ;)!
  202.     - Hopefully fixed reported problems with ST3.2 modules.  Worked
  203.       with all (two ;) modules I tested.  The other was a certain
  204.       crash with 3.04...  Thanks (again the same person above...)
  205.  
  206.  
  207. 3.04ß / 03.12.1994
  208. ­­­­­­­­­­­­­­­­­­
  209.     - Fixed a crash when ejecting immediately after pausing in
  210.       system friendly mode.  Thanks K-P!
  211.     - Fixed some error handling bugs.  Thanks Simply!
  212.     * Rationalized the command line parser, check out the changes in
  213.       syntax!
  214.     + Added primitive setup (the override option from version 2.5),
  215.       which is _NOT_ going to be final, but just a quick & dirty
  216.       hack for your (and mine too!) convenience ;)
  217.  
  218.  
  219. 3.03ß / 05.11.1994
  220. ­­­­­­­­­­­­­­­­­­
  221.     - Fixed a lock-up in the config handling.
  222.  
  223.  
  224. 3.03ß / 03.11.1994
  225. ­­­­­­­­­­­­­­­­­­
  226.     - Fixed that skipping, K-P!
  227.     * Some clean up in the source code...  Hi all of you who
  228.       have asked for those sources.  They are on the way...
  229.  
  230.  
  231. 3.02ß / 30.10.1994
  232. ­­­­­­­­­­­­­­­­­­
  233.     - Quick fix on the mixing system.  000 divide sucks.
  234.  
  235.  
  236. 3.02ß / 28.10.1994
  237. ­­­­­­­­­­­­­­­­­­
  238.     - System killer mode works again...
  239.     - Fixes in the mixing system.
  240.     * Exiting killer mode just pauses the module instead of
  241.       ejecting...
  242.     - Fixes in memory management.
  243.  
  244. ! As you can see from the update rate, I'm pretty busy at the moment due
  245. to my approaching graduation exams.  So please be patient with your
  246. e-mails and letters, I try to answer them as soon as possible even if it
  247. means several weeks. Thank you.
  248.  
  249.  
  250. 3.01ß / 5.10.1994
  251. ­­­­­­­­­­­­­­­­­
  252.     * Mixing system changed a little to get a bit more stable
  253.       consumption of machine power.
  254.     - Fixed to work with my machine again ;) (Simply!  Dump that
  255.       version on your hard disk...)
  256.     - Memory management fixed once again.
  257.  
  258.  
  259. 3.01ß / 29.9.1994
  260. ­­­­­­­­­­­­­­­­­
  261.     * Nearly all memory is now allocated dynamically according to
  262.       current playing mode, amount of channels and such.  So no
  263.       waste memory used anymore!  (Number of hunks dropped from 9 to
  264.       7...)
  265.  
  266.  
  267. 3.01ß / 12.9.1994
  268. ­­­­­­­­­­­­­­­­­
  269.     - Some memory management problems fixed.
  270.  
  271.  
  272. 3.01ß / 11.9.1994
  273. ­­­­­­­­­­­­­­­­­
  274.     + 14-bit mixing speeded up by 2 cycles/byte/channel on 68000!
  275.       Thanks Pauli!
  276.     + 020+ optimized versions finally included!  Improvement is
  277.       mainly directed to 020s as is fits in to the cache, but
  278.       should be faster on any 020+ machine.
  279.  
  280.     ? Sorry for the huge size (35 kB) ;)  It´s a long way from
  281.       the first version and 9 kB...  But I do hope it´s been to
  282.        a better direction!
  283.  
  284.  
  285. 3.00ß / 10.9.1994
  286. ­­­­­­­­­­­­­­­­­
  287.     ! Back to "normal" version numbering ;)
  288.     ! PS3M now has GUI!  "Ripped" from P60 player, but who cares as
  289.       it has all the required features (and because I´m lazy ;).
  290.       Some things are still missing, like proper module list
  291.       functions and configuration window (that shaded gadget), but I
  292.       hope I get them done in the "near" future.
  293.       Enjoy!
  294.  
  295.     ? A known bug: the timer goes crazy at midnight ;)
  296.  
  297.  
  298. 002.6ß / 3.9.1994
  299. ­­­­­­­­­­­­­­­­­
  300.     * Some fixes with the so-called "ALE"-effect and note delay.
  301.  
  302.  
  303. 002.6ß / 28.8.1994
  304. ­­­­­­­­­­­­­­­­­­
  305.     * Proper finetune support for MTMs although the editor doesn´t
  306.       support them, but is compatible with.
  307.     - Fixed that "disappearing surround channels"-bug!  A really
  308.       stupid mistake from my side, not an actual bug...
  309.     - Some other fixes I don´t remember anymore.
  310.  
  311.  
  312. 002.6ß / 11.8.1994
  313. ­­­­­­­­­­­­­­­­­­
  314.     * Still some fixes with MTMs.  All notes were played one half
  315.       note too low as the MTM scale begins from C#0, not C-0...
  316.       (Note 0 means no note at all and that should be C-0...)
  317.     * Vol0-Optimizations are now finally correct.
  318.  
  319.  
  320. 002.6ß / 10.8.1994
  321. ­­­­­­­­­­­­­­­­­­
  322.     * Some fixes with MTMs.  Most of the commands are run also in
  323.       "set frames".
  324.     * Got rid of "twisted" sound with low mixing rates.
  325.  
  326.  
  327. 002.6ß / 26.7.1994
  328. ­­­­­­­­­­­­­­­­­­
  329.     + Proper vol0-optimizations.
  330.     - Loops are now correct also 020+ version.
  331.     - Sample was retrigged when changing only sample in 020+
  332.       version.  That's why the SuperStardust title sounded so
  333.       baaaaad.
  334.  
  335.  
  336. 002.6ß / 18-21.7.1994
  337. ­­­­­­­­­­­­­­­­­­­­­
  338.     * Mixing routines rewritten for 020+.  Old routines which are
  339.       faster on 000/010 are also retained and used when no 020+ is
  340.       found.
  341.  
  342.     * Little changes nearly everywhere.
  343.  
  344.  
  345. 002.5ß / 15-30.6.1994
  346. ­­­­­­­­­­­­­­­­­­­­­
  347.     + 14-bit output!  Needs _Much_ power, but is hopefully worth it.
  348.       Special 020+ optimized version should be included in 002.6.
  349.     + Multitracker (MTM) support!
  350.     + TakeTracker and similar 1-32 channel Protracker-style module
  351.       support.
  352.     - Some fixes with S3M-quirks.
  353.     + Replay version is now also shown in info window to help
  354.       comparision to other players using PS3M-play routine.
  355.     * Show sample names now shows 16 names instead of 20 on one page.
  356.  
  357. Don't worry about that ß, because this is real 002.5.  It's beta just
  358. because I hadn't the time to do some improvements to the mixing routines.
  359.  
  360.  
  361. 002.4 / 12.6.1994
  362. ­­­­­­­­­­­­­­­­­
  363.     + Added show sample names option. Hi Icebeat!
  364.     - Fixed a bug when started from WB.
  365.     + Added contact info text.
  366.     - Little fixes.
  367.  
  368.  
  369. 002.3 / 25.5.1994
  370. ­­­­­­­­­­­­­­­­­
  371.     * Some speed improvements for 020+ (uses more lword access).
  372.       No slow down on 000/010.
  373.     * Recalculated S3M period table for NTSC (was PAL) as ST3 uses
  374.       NTSC periods.
  375.  
  376.     + Little touches here and there (All error messages now start
  377.       with capital letter, etc. :)
  378.     - Fixes in command line parser.  NOTICE: system friendly option
  379.       is now just -s with no extras.  If not present, disable option
  380.       is used.
  381.     - No more crap if no config file present.
  382.     
  383.     Thanks again Deadbeat!
  384.  
  385.  
  386. 002.2 / 9.-10.5.1994
  387. ­­­­­­­­­­­­­­­­­­­­
  388.     (Four versions in three days... maybe I should give myself a break?
  389.      No new versions for a week, promise!)
  390.  
  391.     + REAL SURROUND!
  392.     - Hopefully fixed that >32 kHz bug (Yolk, tell me!)
  393.  
  394.  
  395. 002.1 / 8.5.1994
  396. ­­­­­­­­­­­­­­­­
  397.     (Fast, eh Yolk?)
  398.     + Final solution for the screen mode problem, CIA!  So, now it
  399.       SHOULD work also with those modes.  But who uses them anyway, PAL
  400.       and A500 rule :)
  401.     + BTW, in Productivity mode you can get mixing rate up to 56 kHz!
  402.       Thus artificial 28 kHz limit changed to 56.  Note: as said works
  403.       only in Productivity mode.  (Yolk: You said something about
  404.       working also in double-PAL (double-NTSC too?))
  405.  
  406.  
  407. 002.0 / 8.5.1994
  408. ­­­­­­­­­­­­­­­­
  409.     (Oops, another digit :-)
  410.     + PS3M now has a CONFIG FILE!  It resides in S: and is called
  411.       (surprise, surprise!) PS3M.config.  Check it out for format
  412.       and options.
  413.     - Still little fixes.
  414.     - Channel detection routine had some _serious_ bugs.  Fixed.
  415.     + At last, error messages!
  416.     - Loading a non-existent file crashed the machine.  Fixed.
  417.  
  418.  
  419. 001.1 / 7.5.1994
  420. ­­­­­­­­­­­­­­­­
  421.     - Still more bug fixes in system routines.
  422.     + Should work (at least better) under NTSC and Multiscan modes. (Hi
  423.       Yolk!)
  424.  
  425.  
  426. 001.0 / 5.5.1994
  427. ­­­­­­­­­­­­­­­­
  428.     ? Darn, slipped to the next digit :-)...
  429.     - Fixed a bug in my XPK-loader, should work better although I
  430.       haven't noticed the difference...
  431.     * Changed the priority to 4 to make it more usable with slower
  432.       machines in system friendly mode.
  433.     - Crashes with slow machines should be over! (or at least less...)
  434.     * Changed to colors (now HiP-compatible :-) in system killer mode!
  435.  
  436.     Thanks to K-P Koljonen for these! (Hi again, sending coming
  437.     sometime in the future :)
  438.  
  439.     - The module name wasn't shown if started from command line in
  440.       system friendly mode, fixed.  Thanks Deadbeat!
  441.  
  442.     - Fixed a potential bug in sample offset command.
  443.     - Now you don't have to click the stop gadget twice
  444.  
  445.  
  446. 000.9 / 24.04.1994
  447. ­­­­­­­­­­­­­­­­­­
  448.     + Added FastTracker 6-8 channel and 4 channel ProTracker replay!
  449.     ? Should the name be changed?  Opinions been accepted.
  450.     + Added command line options to bypass the requesters. See usage
  451.       by typing PS3M ?
  452.  
  453.  
  454. 000.8 / 08.04.1994
  455. ­­­­­­­­­­­­­­­­­­
  456.     + Changed the mixing loops to use 6 instructions, which made them
  457.       faster (2 cycles/byte/channel on 68000). Thanks Peter Kunath!
  458.     - Some potantial bugs fixed.
  459.  
  460.  
  461. 000.7 / 22.03.1994
  462. ­­­­­­­­­­­­­­­­­­
  463.     + Added shortcuts for requesters
  464.     + Added skipping of positions $ff, which are separators of
  465.       different songs in one module. Used in TMP.S3M.
  466.  
  467.  
  468. 000.6 / 19.03.1994
  469. ­­­­­­­­­­­­­­­­­­
  470.     - Added range checking to sample offset.
  471.     - Implemented some bugs in STMIK. Now PANIC.S3M plays correctly.
  472.  
  473.  
  474. 000.5 / 08.03.1994
  475. ­­­­­­­­­­­­­­­­­­
  476.     - Some "little" fixes in retrig note. Wonder if it worked at all...
  477.  
  478.  
  479. 000.4 / 25.02.1994
  480. ­­­­­­­­­­­­­­­­­­
  481.     - Ooops, Vibrato+Volslide and Toneportamento+Volslide were the
  482.       wrong way around. Too much Protracker-experience?
  483.  
  484.  
  485. 000.3 / 24.02.1994
  486. ­­­­­­­­­­­­­­­­­­
  487.     + Support for other than 50 Hz screenmodes (was a bug really...)
  488.     + Correct CurrentDir
  489.     ? Crashes under system are probably due to too slow machine as on
  490.       A4000 this doesn't happen at all... Trying to fix it...
  491.     ? Planning some support for other multichannel modules (MTM, 669,
  492.       FastTracker 6 and 8 channels, etc...) Infos about these modules
  493.       are appreciated...
  494.  
  495.  
  496. 000.2 / 10.02.1994
  497. ­­­­­­­­­­­­­­­­­­
  498.     + Added system friendly option!
  499.     - For some odd reason some tunes crash under system...
  500.     ! BTW, my birthday is on the 17th!
  501.  
  502.  
  503. 000.1 / 09.02.1994
  504. ­­­­­­­­­­­­­­­­­­
  505.     - Fixed a bug with volumeslide. Now Satellite One plays correctly.
  506.     - Auch! I had left some fast-mem-only hunks in the executable.
  507.       Fixed.
  508.  
  509.  
  510. 000.0 / 03.02.1994
  511. ­­­­­­­­­­­­­­­­­­
  512.     ! Inital release on public pressure...
  513.